home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / apps / kdeprint / cupsd.conf.template < prev    next >
Text File  |  2008-10-06  |  25KB  |  978 lines
  1. %%header
  2. # CUPS configuration file, generated by CUPS configuration tool.
  3. # This tool is part of KDEPrint, the printing framework for KDE
  4. # since version 2.2.2 and is used by the CUPS supporting module
  5. # in KDEPrint. The predecessors to KDEPrint in former KDE releases
  6. # were KUPS and QtCUPS; they are deprecated and no longer maintained.
  7. #
  8. # Author: Michael Goffioul <kdeprint@swing.be>
  9. #
  10. # Web site: http://printing.kde.org/
  11. #
  12. ########################################################################
  13. #                                                                      #
  14. # This is the CUPS configuration file.  If you are familiar with       #
  15. # Apache or any of the other popular web servers, we've followed the   #
  16. # same format.  Any configuration variable used here has the same      #
  17. # semantics as the corresponding variable in Apache.  If we need       #
  18. # different functionality then a different name is used to avoid       #
  19. # confusion...                                                         #
  20. #                                                                      #
  21. ########################################################################
  22. @@
  23.  
  24. %%servername
  25. # <b>Server name (ServerName)</b>
  26. # <p>
  27. # The hostname of your server, as advertised to the world.
  28. # By default CUPS will use the hostname of the system.</p>
  29. # <p>
  30. # To set the default server used by clients, see the client.conf file.</p>
  31. # <p>
  32. # <i>ex</i>: myhost.domain.com</p>
  33. $$
  34. #ServerName myhost.domain.com
  35. @@
  36.  
  37. %%serveradmin
  38. # <b>Server administrator (ServerAdmin)</b>
  39. # <p>
  40. # The email address to send all complaints or problems to.
  41. # By default CUPS will use "root@hostname".</p>
  42. # <p>
  43. # <i>ex</i>: root@myhost.com</p>
  44. $$
  45. #ServerAdmin root@your.domain.com
  46. @@
  47.  
  48. %%accesslog
  49. # <b>Access log (AccessLog)</b>
  50. # <p>
  51. # The access log file; if this does not start with a leading /
  52. # then it is assumed to be relative to ServerRoot.  By default set to
  53. # "/var/log/cups/access_log".</p>
  54. # <p>
  55. # You can also use the special name <b>syslog</b> to send the output to the
  56. # syslog file or daemon.</p>
  57. # <p>
  58. # <i>ex</i>: /var/log/cups/access_log</p>
  59. $$
  60. #AccessLog /var/log/cups/access_log
  61. @@
  62.  
  63. %%datadir
  64. # <b>Data directory (DataDir)</b>
  65. # <p>
  66. # The root directory for the CUPS data files.
  67. # By default /usr/share/cups.</p>
  68. # <p>
  69. # <i>ex</i>: /usr/share/cups</p>
  70. $$
  71. #DataDir /usr/share/cups
  72. @@
  73.  
  74. %%defaultcharset
  75. # <b>Default character set (DefaultCharset)</b>
  76. # <p>
  77. # The default character set to use. If not specified,
  78. # defaults to utf-8.  Note that this can also be overridden in
  79. # HTML documents...</p>
  80. # <p>
  81. # <i>ex</i>: utf-8</p>
  82. $$
  83. #DefaultCharset utf-8
  84. @@
  85.  
  86. %%defaultlanguage
  87. # <b>Default language (DefaultLanguage)</b>
  88. # <p>
  89. # The default language if not specified by the browser.
  90. # If not specified, the current locale is used.</p>
  91. # <p>
  92. # <i>ex</i>: en</p>
  93. $$
  94. #DefaultLanguage en
  95. @@
  96.  
  97. %%documentroot
  98. # <b>Document directory (DocumentRoot)</b>
  99. # <p>
  100. # The root directory for HTTP documents that are served.
  101. # By default the compiled-in directory.</p>
  102. # <p>
  103. # <i>ex</i>: /usr/share/cups/doc-root</p>
  104. $$
  105. #DocumentRoot /usr/share/cups/doc-root
  106. @@
  107.  
  108. %%errorlog
  109. # <b>Error log (ErrorLog)</b>
  110. # <p>
  111. # The error log file; if this does not start with a leading /
  112. # then it is assumed to be relative to ServerRoot.  By default set to
  113. # "/var/log/cups/error_log".</p>
  114. # <p>
  115. # You can also use the special name <b>syslog</b> to send the output to the
  116. # syslog file or daemon.</p>
  117. # <p>
  118. # <i>ex</i>: /var/log/cups/error_log</p>
  119. $$
  120. #ErrorLog /var/log/cups/error_log
  121. @@
  122.  
  123. %%fontpath
  124. # <b>Font path (FontPath)</b>
  125. # <p>
  126. # The path to locate all font files (currently only for pstoraster).
  127. # By default /usr/share/cups/fonts.</p>
  128. # <p>
  129. # <i>ex</i>: /usr/share/cups/fonts</p>
  130. $$
  131. #FontPath /usr/share/cups/fonts
  132. @@
  133.  
  134. %%loglevel
  135. # <b>Log level (LogLevel)</b>
  136. # <p>
  137. # Controls the number of messages logged to the ErrorLog
  138. # file and can be one of the following:</p>
  139. # <ul type=circle>
  140. #     <li><i>debug2</i>:     Log everything.</li>
  141. #     <li><i>debug</i>:     Log almost everything.</li>
  142. #     <li><i>info</i>:      Log all requests and state changes.</li>
  143. #     <li><i>warn</i>:      Log errors and warnings.</li>
  144. #     <li><i>error</i>:     Log only errors.</li>
  145. #     <li><i>none</i>:      Log nothing.</li>
  146. # </ul><p>
  147. # <i>ex</i>: info</p>
  148. $$
  149. #LogLevel info
  150. @@
  151.  
  152. %%maxlogsize
  153. # <b>Max log size (MaxLogSize)</b>
  154. # <p>
  155. # Controls the maximum size of each log file before they are
  156. # rotated.  Defaults to 1048576 (1MB).  Set to 0 to disable log rotating.</p>
  157. # <p>
  158. # <i>ex</i>: 1048576</p>
  159. $$
  160. #MaxLogSize 0
  161. @@
  162.  
  163. %%pagelog
  164. # <b>Page log (PageLog)</b>
  165. # <p>
  166. # The page log file; if this does not start with a leading /
  167. # then it is assumed to be relative to ServerRoot.  By default set to
  168. # "/var/log/cups/page_log".</p>
  169. # <p>
  170. # You can also use the special name <b>syslog</b> to send the output to the
  171. # syslog file or daemon.</p>
  172. # <p>
  173. # <i>ex</i>: /var/log/cups/page_log</p>
  174. $$
  175. #PageLog /var/log/cups/page_log
  176. @@
  177.  
  178. %%preservejobhistory
  179. # <b>Preserve job history (PreserveJobHistory)</b>
  180. # <p>
  181. # Whether or not to preserve the job history after a
  182. # job is completed, canceled, or stopped.  Default is Yes.</p>
  183. # <p>
  184. # <i>ex</i>: Yes</p>
  185. $$
  186. #PreserveJobHistory Yes
  187. @@
  188.  
  189. %%preservejobfiles
  190. # <b>Preserve job files (PreserveJobFiles)</b>
  191. # <p>
  192. # Whether or not to preserve the job files after a
  193. # job is completed, canceled, or stopped.  Default is No.</p>
  194. # <p>
  195. # <i>ex</i>: No</p>
  196. $$
  197. #PreserveJobFiles No
  198. @@
  199.  
  200. %%printcap
  201. # <b>Printcap file (Printcap)</b>
  202. # <p>
  203. # The name of the printcap file.  Default is no filename.
  204. # Leave blank to disable printcap file generation.</p>
  205. # <p>
  206. # <i>ex</i>: /etc/printcap</p>
  207. $$
  208. #Printcap /etc/printcap
  209. @@
  210.  
  211. %%requestroot
  212. # <b>Request directory (RequestRoot)</b>
  213. # <p>
  214. # The directory where request files are stored.
  215. # By default /var/spool/cups.</p>
  216. # <p>
  217. # <i>ex</i>: /var/spool/cups</p>
  218. $$
  219. #RequestRoot /var/spool/cups
  220. @@
  221.  
  222. %%remoteroot
  223. # <b>Remote root user (RemoteRoot)</b>
  224. # <p>
  225. # The name of the user assigned to unauthenticated accesses
  226. # from remote systems.  By default "remroot".</p>
  227. # <p>
  228. # <i>ex</i>: remroot</p>
  229. $$
  230. #RemoteRoot remroot
  231. @@
  232.  
  233. %%serverbin
  234. # <b>Server binaries (ServerBin)</b>
  235. # <p>
  236. # The root directory for the scheduler executables.
  237. # By default /usr/lib/cups or /usr/lib32/cups (IRIX 6.5).</p>
  238. # <p>
  239. # <i>ex</i>: /usr/lib/cups</p>
  240. $$
  241. #ServerBin /usr/lib/cups
  242. @@
  243.  
  244. %%serverroot
  245. # <b>Server files (ServerRoot)</b>
  246. # <p>
  247. # The root directory for the scheduler.
  248. # By default /etc/cups.</p>
  249. # <p>
  250. # <i>ex</i>: /etc/cups</p>
  251. $$
  252. #ServerRoot /etc/cups
  253. @@
  254.  
  255. %%user
  256. # <b>User (User)</b>
  257. # <p>
  258. # The user the server runs under.  Normally this
  259. # must be <b>lp</b>, however you can configure things for another user
  260. # as needed.</p>
  261. # <p>
  262. # Note: the server must be run initially as root to support the
  263. # default IPP port of 631.  It changes users whenever an external
  264. # program is run...</p>
  265. # <p>
  266. # <i>ex</i>: lp</p>
  267. $$
  268. #User lp
  269. @@
  270.  
  271. %%group
  272. # <b>Group (Group)</b>
  273. # <p>
  274. # The group the server runs under.  Normally this
  275. # must be <b>lpadmin</b>, however you can configure things for another
  276. # group as needed.</p>
  277. # <p>
  278. # <i>ex</i>: lpadmin</p>
  279. $$
  280. #Group lpadmin
  281. @@
  282.  
  283. %%ripcache
  284. # <b>RIP cache (RIPCache)</b>
  285. # <p>
  286. # The amount of memory that each RIP should use to cache
  287. # bitmaps.  The value can be any real number followed by "k" for
  288. # kilobytes, "m" for megabytes, "g" for gigabytes, or "t" for tiles
  289. # (1 tile = 256x256 pixels).  Defaults to "8m" (8 megabytes).</p>
  290. # <p>
  291. # <i>ex</i>: 8m</p>
  292. $$
  293. #RIPCache 8m
  294. @@
  295.  
  296. %%tempdir
  297. # <b>Temporary files (TempDir)</b>
  298. # <p>
  299. # The directory to put temporary files in. This directory must be
  300. # writable by the user defined above!  Defaults to "/var/spool/cups/tmp" or
  301. # the value of the TMPDIR environment variable.</p>
  302. # <p>
  303. # <i>ex</i>: /var/spool/cups/tmp</p>
  304. $$
  305. #TempDir /var/spool/cups/tmp
  306. @@
  307.  
  308. %%filterlimit
  309. # <b>Filter limit (FilterLimit)</b>
  310. # <p>
  311. # Sets the maximum cost of all job filters that can be run
  312. # at the same time.  A limit of 0 means no limit.  A typical job may need
  313. # a filter limit of at least 200; limits less than the minimum required
  314. # by a job force a single job to be printed at any time.</p>
  315. # <p>
  316. # The default limit is 0 (unlimited).</p>
  317. # <p>
  318. # <i>ex</i>: 200</p>
  319. $$
  320. #FilterLimit 0
  321. @@
  322.  
  323. %%listen
  324. # <b>Listen to (Port/Listen)</b>
  325. # <p>
  326. # Ports/addresses that are listened to.  The default port 631 is reserved
  327. # for the Internet Printing Protocol (IPP) and is what is used here.</p>
  328. # <p>
  329. # You can have multiple Port/Listen lines to listen to more than one
  330. # port or address, or to restrict access.</p>
  331. # <p>
  332. # Note: Unfortunately, most web browsers don't support TLS or HTTP Upgrades
  333. # for encryption.  If you want to support web-based encryption you will
  334. # probably need to listen on port 443 (the "HTTPS" port...).</p>
  335. # <p>
  336. # <i>ex</i>: 631, myhost:80, 1.2.3.4:631</p>
  337. $$
  338. #    Port 80
  339. #    Port 631
  340. #    Listen hostname
  341. #    Listen hostname:80
  342. #    Listen hostname:631
  343. #    Listen 1.2.3.4
  344. #    Listen 1.2.3.4:631
  345. #
  346. #Port 631
  347. @@
  348.  
  349. %%hostnamelookups
  350. # <b>Hostname lookups (HostNameLookups)</b>
  351. # <p>
  352. # Whether or not to do lookups on IP addresses to get a
  353. # fully-qualified hostname.  This defaults to Off for performance reasons...</p>
  354. # <p>
  355. # <i>ex</i>: On</p>
  356. $$
  357. #HostNameLookups On
  358. @@
  359.  
  360. %%keepalive
  361. # <b>Keep alive (KeepAlive)</b>
  362. # <p>
  363. # Whether or not to support the Keep-Alive connection
  364. # option.  Default is on.</p>
  365. # <p>
  366. # <i>ex</i>: On</p>
  367. $$
  368. #KeepAlive On
  369. @@
  370.  
  371. %%keepalivetimeout
  372. # <b>Keep-alive timeout (KeepAliveTimeout)</b>
  373. # <p>
  374. # The timeout (in seconds) before Keep-Alive connections are
  375. # automatically closed.  Default is 60 seconds.</p>
  376. # <p>
  377. # <i>ex</i>: 60</p>
  378. $$
  379. #KeepAliveTimeout 60
  380. @@
  381.  
  382. %%maxclients
  383. # <b>Max clients (MaxClients)</b>
  384. # <p>
  385. # Controls the maximum number of simultaneous clients that
  386. # will be handled.  Defaults to 100.</p>
  387. # <p>
  388. # <i>ex</i>: 100</p>
  389. $$
  390. #MaxClients 100
  391. @@
  392.  
  393. %%maxrequestsize
  394. # <b>Max request size (MaxRequestSize)</b>
  395. # <p>
  396. # Controls the maximum size of HTTP requests and print files.
  397. # Set to 0 to disable this feature (defaults to 0).</p>
  398. # <p>
  399. # <i>ex</i>: 0</p>
  400. $$
  401. #MaxRequestSize 0
  402. @@
  403.  
  404. %%timeout
  405. # <b>Client timeout (Timeout)</b>
  406. # <p>
  407. # The timeout (in seconds) before requests time out.  Default is 300 seconds.</p>
  408. # <p>
  409. # <i>ex</i>: 300</p>
  410. $$
  411. #Timeout 300
  412. @@
  413.  
  414. %%browsing
  415. # <b>Use browsing (Browsing)</b>
  416. # <p>
  417. # Whether or not to <b>listen</b> to printer 
  418. # information from other CUPS servers.  
  419. # </p>
  420. # <p>
  421. # Enabled by default.
  422. # </p>
  423. # <p>
  424. # Note: to enable the <b>sending</b> of browsing
  425. # information from this CUPS server to the LAN,
  426. # specify a valid <i>BrowseAddress</i>.
  427. # </p>
  428. # <p>
  429. # <i>ex</i>: On</p>
  430. $$
  431. #Browsing On
  432. @@
  433.  
  434. %%browseshortnames
  435. # <b>Use short names (BrowseShortNames)</b>
  436. # <p>
  437. # Whether or not to use "short" names for remote printers
  438. # when possible (e.g. "printer" instead of "printer@host").  Enabled by
  439. # default.</p>
  440. # <p>
  441. # <i>ex</i>: Yes</p>
  442. $$
  443. #BrowseShortNames Yes
  444. @@
  445.  
  446. %%browseaddress
  447. # <b>Browse addresses (BrowseAddress)</b>
  448. # <p>
  449. # Specifies a broadcast address to be used.  By
  450. # default browsing information is broadcast to all active interfaces.</p>
  451. # <p>
  452. # Note: HP-UX 10.20 and earlier do not properly handle broadcast unless
  453. # you have a Class A, B, C, or D netmask (i.e. no CIDR support).</p>
  454. # <p>
  455. # <i>ex</i>: x.y.z.255, x.y.255.255</p>
  456. $$
  457. #BrowseAddress x.y.z.255
  458. #BrowseAddress x.y.255.255
  459. #BrowseAddress x.255.255.255
  460. @@
  461.  
  462. %%browseallow
  463. # <b>Browse allow/deny (BrowseAllow/BrowseDeny)</b>
  464. # <p>
  465. # <u>BrowseAllow</u>: specifies an address mask to allow for incoming browser
  466. # packets. The default is to allow packets from all addresses.</p>
  467. # <p>
  468. # <u>BrowseDeny</u>: specifies an address mask to deny for incoming browser
  469. # packets. The default is to deny packets from no addresses.</p>
  470. # <p>
  471. # Both "BrowseAllow" and "BrowseDeny" accept the following notations for
  472. # addresses:</p>
  473. # <pre>
  474. #     All
  475. #     None
  476. #     *.domain.com
  477. #     .domain.com
  478. #     host.domain.com
  479. #     nnn.*
  480. #     nnn.nnn.*
  481. #     nnn.nnn.nnn.*
  482. #     nnn.nnn.nnn.nnn
  483. #     nnn.nnn.nnn.nnn/mm
  484. #     nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
  485. # </pre><p>
  486. # The hostname/domainname restrictions only work if you have turned hostname
  487. # lookups on!</p>
  488. $$
  489. #BrowseAllow address
  490. #BrowseDeny address
  491. @@
  492.  
  493. %%browseinterval
  494. # <b>Browse interval (BrowseInterval)</b>
  495. # <p>
  496. # The time between browsing updates in seconds.  Default
  497. # is 30 seconds.</p>
  498. # <p>
  499. # Note that browsing information is sent whenever a printer's state changes
  500. # as well, so this represents the maximum time between updates.</p>
  501. # <p>
  502. # Set this to 0 to disable outgoing broadcasts so your local printers are
  503. # not advertised but you can still see printers on other hosts.</p>
  504. # <p>
  505. # <i>ex</i>: 30</p>
  506. $$
  507. #BrowseInterval 30
  508. @@
  509.  
  510. %%browseorder
  511. # <b>Browse order (BrowseOrder)</b>
  512. # <p>
  513. # Specifies the order of BrowseAllow/BrowseDeny comparisons.</p>
  514. # <p>
  515. # <i>ex</i>: allow,deny</p>
  516. $$
  517. #BrowseOrder allow,deny
  518. #BrowseOrder deny,allow
  519. @@
  520.  
  521. %%browsepoll
  522. # <b>Browse poll (BrowsePoll)</b>
  523. # <p>
  524. # Poll the named server(s) for printers.</p>
  525. # <p>
  526. # <i>ex</i>: myhost:631</p>
  527. $$
  528. #BrowsePoll address:port
  529. @@
  530.  
  531. %%browseport
  532. # <b>Browse port (BrowsePort)</b>
  533. # <p>
  534. # The port used for UDP broadcasts.  By default this is
  535. # the IPP port; if you change this you need to do it on all servers.
  536. # Only one BrowsePort is recognized.</p>
  537. # <p>
  538. # <i>ex</i>: 631</p>
  539. $$
  540. #BrowsePort 631
  541. @@
  542.  
  543. %%browserelay
  544. # <b>Browse relay (BrowseRelay)</b>
  545. # <p>
  546. # Relay browser packets from one address/network to another.</p>
  547. # <p>
  548. # <i>ex</i>: src-address dest-address</p>
  549. $$
  550. #BrowseRelay source-address destination-address
  551. @@
  552.  
  553. %%browsetimeout
  554. # <b>Browse timeout (BrowseTimeout)</b>
  555. # <p>
  556. # The timeout (in seconds) for network printers - if we don't
  557. # get an update within this time the printer will be removed
  558. # from the printer list.  This number definitely should not be
  559. # less the BrowseInterval value for obvious reasons.  Defaults
  560. # to 300 seconds.</p>
  561. # <p>
  562. # <i>ex</i>: 300</p>
  563. $$
  564. #BrowseTimeout 300
  565. @@
  566.  
  567. %%implicitclasses
  568. # <b>Implicit classes (ImplicitClasses)</b>
  569. # <p>
  570. # Whether or not to use implicit classes.</p>
  571. # <p>
  572. # Printer classes can be specified explicitly in the classes.conf
  573. # file, implicitly based upon the printers available on the LAN, or
  574. # both.</p>
  575. # <p>
  576. # When ImplicitClasses is On, printers on the LAN with the same name
  577. # (e.g. Acme-LaserPrint-1000) will be put into a class with the same
  578. # name. This allows you to setup multiple redundant queues on a LAN
  579. # without a lot of administrative difficulties.  If a user sends a
  580. # job to Acme-LaserPrint-1000, the job will go to the first available
  581. # queue.</p>
  582. # <p>
  583. # Enabled by default.</p>
  584. $$
  585. #ImplicitClasses Off
  586. @@
  587.  
  588. %%systemgroup
  589. # <b>System group (SystemGroup)</b>
  590. # <p>
  591. # The group name for "System" (printer administration)
  592. # access.  The default varies depending on the operating system, but
  593. # will be <b>sys</b>, <b>system</b>, or <b>root</b> (checked for in that order).</p>
  594. # <p>
  595. # <i>ex</i>: lpadmin</p>
  596. $$
  597. #SystemGroup lpadmin
  598. @@
  599.  
  600. %%servercertificate
  601. # <b>Encryption certificate (ServerCertificate)</b>
  602. # <p>
  603. # The file to read containing the server's certificate.
  604. # Defaults to "/etc/cups/ssl/server.crt".</p>
  605. # <p>
  606. # <i>ex</i>: /etc/cups/ssl/server.crt</p>
  607. $$
  608. #ServerCertificate /etc/cups/ssl/server.crt
  609. @@
  610.  
  611. %%serverkey
  612. # <b>Encryption key (ServerKey)</b>
  613. # <p>
  614. # The file to read containing the server's key.
  615. # Defaults to "/etc/cups/ssl/server.key".</p>
  616. # <p>
  617. # <i>ex</i>: /etc/cups/ssl/server.key</p>
  618. $$
  619. #ServerKey /etc/cups/ssl/server.key
  620. @@
  621.  
  622. %%locations
  623. # Access permissions
  624. #
  625. # Access permissions for each directory served by the scheduler.
  626. # Locations are relative to DocumentRoot...
  627. #
  628. # AuthType: the authorization to use:
  629. #
  630. #    None   - Perform no authentication
  631. #    Basic  - Perform authentication using the HTTP Basic method.
  632. #    Digest - Perform authentication using the HTTP Digest method.
  633. #
  634. #    (Note: local certificate authentication can be substituted by
  635. #           the client for Basic or Digest when connecting to the
  636. #           localhost interface)
  637. #
  638. # AuthClass: the authorization class; currently only Anonymous, User,
  639. # System (valid user belonging to group SystemGroup), and Group
  640. # (valid user belonging to the specified group) are supported.
  641. #
  642. # AuthGroupName: the group name for "Group" authorization.
  643. #
  644. # Order: the order of Allow/Deny processing.
  645. #
  646. # Allow: allows access from the specified hostname, domain, IP address, or
  647. # network.
  648. #
  649. # Deny: denies access from the specified hostname, domain, IP address, or
  650. # network.
  651. #
  652. # Both "Allow" and "Deny" accept the following notations for addresses:
  653. #
  654. #     All
  655. #     None
  656. #     *.domain.com
  657. #     .domain.com
  658. #     host.domain.com
  659. #     nnn.*
  660. #     nnn.nnn.*
  661. #     nnn.nnn.nnn.*
  662. #     nnn.nnn.nnn.nnn
  663. #     nnn.nnn.nnn.nnn/mm
  664. #     nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
  665. #
  666. # The host and domain address require that you enable hostname lookups
  667. # with "HostNameLookups On" above.
  668. #
  669. # Encryption: whether or not to use encryption; this depends on having
  670. # the OpenSSL library linked into the CUPS library and scheduler.
  671. #
  672. # Possible values:
  673. #
  674. #     Always       - Always use encryption (SSL)
  675. #     Never        - Never use encryption
  676. #     Required     - Use TLS encryption upgrade
  677. #     IfRequested  - Use encryption if the server requests it
  678. #
  679. # The default value is "IfRequested".
  680. $$
  681. #<Location [resource_name]>
  682. #
  683. # You may wish to limit access to printers and classes, either with Allow
  684. # and Deny lines, or by requiring a username and password.
  685. #
  686. #
  687. ## Anonymous access (default)
  688. #AuthType None
  689. #
  690. ## Require a username and password (Basic authentication)
  691. #AuthType Basic
  692. #AuthClass User
  693. #
  694. ## Require a username and password (Digest/MD5 authentication)
  695. #AuthType Digest
  696. #AuthClass User
  697. #
  698. ## Restrict access to local domain
  699. #Order Deny,Allow
  700. #Deny From All
  701. #Allow From .mydomain.com
  702. #
  703. ## Use encryption if requested
  704. #Encryption IfRequested
  705. #</Location>
  706. @@
  707.  
  708. %%authtype
  709. # <b>Authentication (AuthType)</b>
  710. # <p>
  711. # The authorization to use:<p>
  712. # <ul type=circle>
  713. #    <li><i>None</i>   - Perform no authentication.</li>
  714. #    <li><i>Basic</i>  - Perform authentication using the HTTP Basic method.</li>
  715. #    <li><i>Digest</i> - Perform authentication using the HTTP Digest method.</li>
  716. # </ul><p>
  717. #    Note: local certificate authentication can be substituted by
  718. #          the client for <i>Basic</i> or <i>Digest</i> when connecting to the
  719. #          localhost interface.</p>
  720. @@
  721.  
  722. %%authclass
  723. # <b>Class (AuthClass)</b>
  724. # <p>
  725. # The authorization class; currently only <i>Anonymous</i>, <i>User</i>,
  726. # <i>System</i> (valid user belonging to group SystemGroup), and <i>Group</i>
  727. # (valid user belonging to the specified group) are supported.</p>
  728. @@
  729.  
  730. %%authname
  731. # <p>The user/group names allowed to access the resource. The format is a
  732. # comma separated list.</p>
  733. @@
  734.  
  735. %%satisfy
  736. # <b>Satisfy (Satisfy)</b>
  737. # <p>
  738. #  This directive controls whether all specified conditions must
  739. #  be satisfied to allow access to the resource. If set to "all",
  740. #  then all authentication and access control conditions must be
  741. #  satisfied to allow access.
  742. # </p>
  743. # <p>
  744. #  Setting Satisfy to "any" allows a user to gain access if the
  745. #  authentication <i>or</i> access control requirements are satisfied.
  746. #  For example, you might require authentication for remote access,
  747. #  but allow local access without authentication.
  748. # </p>
  749. # <p>
  750. #  The default is "all".
  751. # </p> 
  752. @@
  753.  
  754. %%authgroupname
  755. # <b>Authentication group name (AuthGroupName)</b>
  756. # <p>
  757. # The group name for <i>Group</i> authorization.</p>
  758. @@
  759.  
  760. %%order
  761. # <b>ACL order (Order)</b>
  762. # <p>
  763. # The order of Allow/Deny processing.</p>
  764. @@
  765.  
  766. %%allow
  767. # <b>Allow</b>
  768. # <p>
  769. # Allows access from the specified hostname, domain, IP address, or
  770. # network. Possible values are:</p>
  771. # <pre>
  772. #     All
  773. #     None
  774. #     *.domain.com
  775. #     .domain.com
  776. #     host.domain.com
  777. #     nnn.*
  778. #     nnn.nnn.*
  779. #     nnn.nnn.nnn.*
  780. #     nnn.nnn.nnn.nnn
  781. #     nnn.nnn.nnn.nnn/mm
  782. #     nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
  783. # </pre><p>
  784. # The host and domain address require that you enable hostname lookups
  785. # with "HostNameLookups On" above.</p>
  786. @@
  787.  
  788. %%allowdeny
  789. # <b>ACL addresses (Allow/Deny)</b>
  790. # <p>
  791. # Allows/Denies access from the specified hostname, domain, IP address, or
  792. # network. Possible values are:</p>
  793. # <pre>
  794. #     All
  795. #     None
  796. #     *.domain.com
  797. #     .domain.com
  798. #     host.domain.com
  799. #     nnn.*
  800. #     nnn.nnn.*
  801. #     nnn.nnn.nnn.*
  802. #     nnn.nnn.nnn.nnn
  803. #     nnn.nnn.nnn.nnn/mm
  804. #     nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
  805. # </pre><p>
  806. # The host and domain address require that you enable hostname lookups
  807. # with "HostNameLookups On" above.</p>
  808. @@
  809.  
  810. %%encryption
  811. # <b>Encryption (Encryption)</b>
  812. # <p>
  813. # Whether or not to use encryption; this depends on having
  814. # the OpenSSL library linked into the CUPS library and scheduler.</p>
  815. # <p>
  816. # Possible values:</p>
  817. # <ul type=circle>
  818. #     <li><i>Always</i>       - Always use encryption (SSL)</li>
  819. #     <li><i>Never</i>        - Never use encryption</li>
  820. #     <li><i>Required</i>     - Use TLS encryption upgrade</li>
  821. #     <li><i>IfRequested</i>  - Use encryption if the server requests it</li>
  822. # </ul><p>
  823. # The default value is "IfRequested".</p>
  824. @@
  825.  
  826. %%locationsshort
  827. # <b>Access permissions</b>
  828. # <p>
  829. # Access permissions for each directory served by the scheduler.
  830. # Locations are relative to DocumentRoot...</p>
  831. @@
  832.  
  833. %%autopurgejobs
  834. # <b>Auto purge jobs (AutoPurgeJobs)</b>
  835. # <p>
  836. # Automatically purge jobs when not needed for quotas.
  837. # Default is No.</p>
  838. $$
  839. #AutoPurgeJobs No
  840. @@
  841.  
  842. %%browseprotocols
  843. # <b>Browse protocols (BrowseProtocols)</b>
  844. # <p>
  845. # Which protocols to use for browsing.  Can be
  846. # any of the following separated by whitespace and/or commas:</p>
  847. # <ul type=circle>
  848. #     <li><i>all</i>  - Use all supported protocols.</li>
  849. #     <li><i>cups</i> - Use the CUPS browse protocol.</li>
  850. #     <li><i>slp</i>  - Use the SLPv2 protocol.</li>
  851. # </ul><p>
  852. # The default is <b>cups</b>.</p>
  853. # <p>
  854. # Note: If you choose to use SLPv2, it is <b>strongly</b> recommended that
  855. #       you have at least one SLP Directory Agent (DA) on your
  856. #       network.  Otherwise, browse updates can take several seconds,
  857. #       during which the scheduler will not response to client
  858. #       requests.</p>
  859. $$
  860. #BrowseProtocols cups
  861. @@
  862.  
  863. %%classification
  864. # <b>Classification (Classification)</b>
  865. # <p>
  866. # The classification level of the server.  If set, this
  867. # classification is displayed on all pages, and raw printing is disabled.
  868. # The default is the empty string.</p>
  869. # <p>
  870. # <i>ex</i>: confidential
  871. $$
  872. #Classification classified
  873. @@
  874.  
  875. %%classifyoverride
  876. # <b>Allow overrides (ClassifyOverride)</b>
  877. # <p>
  878. # Whether to allow users to override the classification
  879. # on printouts. If enabled, users can limit banner pages to before or
  880. # after the job, and can change the classification of a job, but cannot
  881. # completely eliminate the classification or banners.</p>
  882. # <p>
  883. # The default is off.</p>
  884. $$
  885. #ClassifyOverride off
  886. @@
  887.  
  888. %%hideimplicitmembers
  889. # <b>Hide implicit members (HideImplicitMembers)</b>
  890. # <p>
  891. # Whether or not to show the members of an
  892. # implicit class.</p>
  893. # <p>
  894. # When HideImplicitMembers is On, any remote printers that are
  895. # part of an implicit class are hidden from the user, who will
  896. # then only see a single queue even though many queues will be
  897. # supporting the implicit class.</p>
  898. # <p>
  899. # Enabled by default.</p>
  900. $$
  901. #HideImplicitMembers On
  902. @@
  903.  
  904. %%implicitanyclasses
  905. # <b>Use "any" classes (ImplicitAnyClasses)</b>
  906. # <p>
  907. # Whether or not to create <b>AnyPrinter</b> implicit
  908. # classes.</p>
  909. # <p>
  910. # When ImplicitAnyClasses is On and a local queue of the same name
  911. # exists, e.g. "printer", "printer@server1", "printer@server1", then
  912. # an implicit class called "Anyprinter" is created instead.</p>
  913. # <p>
  914. # When ImplicitAnyClasses is Off, implicit classes are not created
  915. # when there is a local queue of the same name.</p>
  916. # <p>
  917. # Disabled by default.</p>
  918. $$
  919. #ImplicitAnyCLasses Off
  920. @@
  921.  
  922. %%maxjobs
  923. # <b>Max jobs (MaxJobs)</b>
  924. # <p>
  925. # Maximum number of jobs to keep in memory (active and completed).
  926. # Default is 0 (no limit).</p>
  927. $$
  928. #MaxJobs 0
  929. @@
  930.  
  931. %%maxjobsperuser
  932. # <b>Max jobs per user (MaxJobsPerUser)</b>
  933. # <p>
  934. # The MaxJobsPerUser directive controls the maximum number of <i>active</i>
  935. # jobs that are allowed for each user. Once a user reaches the limit, new
  936. # jobs will be rejected until one of the active jobs is completed, stopped,
  937. # aborted, or canceled.</p>
  938. # <p>
  939. # Setting the maximum to 0 disables this functionality.
  940. # Default is 0 (no limit).
  941. # </p>
  942. $$
  943. #MaxJobsPerUser 0
  944. @@
  945.  
  946. %%maxjobsperprinter
  947. # <b>Max jobs per printer (MaxJobsPerPrinter)</b>
  948. # <p>
  949. # The MaxJobsPerPrinter directive controls the maximum number of <i>active</i>
  950. # jobs that are allowed for each printer or class. Once a printer or class
  951. # reaches the limit, new jobs will be rejected until one of the active jobs
  952. # is completed, stopped, aborted, or canceled.</p>
  953. # <p>
  954. # Setting the maximum to 0 disables this functionality.
  955. # Default is 0 (no limit).
  956. # </p>
  957. $$
  958. #MaxJobsPerPrinter 0
  959. @@
  960.  
  961. %%port
  962. # <b>Port</b>
  963. # <p>
  964. # The port value that the CUPS daemon is listening to. Default is 631.</p>
  965. @@
  966.  
  967. %%address
  968. # <b>Address</b>
  969. # <p>
  970. # The address that the CUPS daemon is listening at. Leave it empty or use
  971. # an asterisk (*) to specify a port value on the entire subnetwork.</p>
  972. @@
  973.  
  974. %%usessl
  975. # <p>Check this box if you want to use SSL encryption with this address/port.
  976. # </p>
  977. @@
  978.